home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / PRNTTEXT.HDR < prev    next >
Text File  |  1994-04-25  |  2KB  |  70 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Print_Text( cFileName, nLinesPerPage, nPageNum, cExcludeText ) --> NIL
  8.  
  9. PARAMETERS:
  10.  
  11. cFileName     : Text File to Print
  12. nLinesPerPage : Lines per page (Default 55)
  13. nPageNum      : Beginning Page Number
  14. cExcludeText  : Text criteria to Exclude Lines
  15.  
  16. SHORT:
  17.  
  18. Print text to printer (no formatting).
  19.  
  20. DESCRIPTION:
  21.  
  22. _Print_Text() prints a DOS text file (Source Code, etc).  If the
  23. nLinesPerPage argument is not supplied, the default is 55 lines per page.
  24.  
  25. If the nPageNum argument is supplied, page numbering begins with that
  26. value, and the internal page number is set to that value also
  27. (subsequent calls to _Print_Text() will continue with that page number).
  28.  
  29. If nPageNum is NOT supplied, the function looks first for it's internal
  30. page number and if present, uses it. If the nPageNum argument is not
  31. supplied and there is no internal page number yet established, page
  32. numbering begins with 1 and 1 becomes the internal page number.
  33.  
  34. The internal page number is stored in PAGENUM.DAT, thus allowing subsequent
  35. calls to _Print_Text() to maintain page numbers across multiple files.  To
  36. reset page numbering, either specify the new beginning page number in
  37. nPageNum, or deleted the PAGENUM.MEM file.
  38.  
  39. If cExcludeText is not specified, all lines of text are printed.
  40.  
  41. If cExcludeText IS specified, any line in the input file that contains the
  42. text specified in cExcludeText, is skipped.
  43.  
  44. This function makes no printer setting changes.  Any printer settings
  45. required must be set manually before printing.
  46.  
  47. _Print_File() and _Print_Text() use the same PAGENUM.MEM file and
  48. can therefore be used together without losing page numbering
  49.  
  50. NOTE:
  51.  
  52. _Print_Text() is the generic text printer equivalent of _Print_File().
  53.  
  54. EXAMPLE:
  55.  
  56. _Print_Text('File1.txt',,1)
  57. _Print_Text('File2.txt')
  58.  
  59. Result: File1.txt is printed, beginning page numbers at 1, and then
  60. FILE2.TXT is printed, CONTINUING page numbers from FILE1.TXT (whatever
  61. that page number may be).
  62.  
  63. _Print_Text('File1.txt',,1)
  64. _Print_Text('File2.txt',,1)
  65.  
  66. Result: FILE1.TXT is printed, beginning page numbering at 1, and
  67. then FILE2.TXT is printed, ALSO beginning page numbering at 1.
  68.  
  69. ******************************************************************************/
  70.